﻿precip.abund                 package:-                R Documentation

Plotar gráficos de abundância e precipitação de dados coletados e simulados

Description:

A função precip.abund calcula índice de abundância através da divisão do número de indivíduos 
por quantidade de água coletada, usando esse índice para plotar um gráfico que mostra a distribuição 
desse índice por quantidade de precipitação (mM) por coleta. Ela gera também um gráfico com as 
mesmas características já descritas, porém, com os dados misturados, simulando assim diferentes 
situações com os dados já conhecidos.

Usage:


precip.abund(dados,L=TRUE)

Arguments:

dados               Data.frame com quatro colunas: primeira com o número da coleta,
                    segunda com a quantidade de água coletada, terceira com o 
                    número de indivíduos coletados, quarta com a precipitação
                    acumulada (período escolhido pelo usuário).

L                   Argumento para transformação da quantidade de água coletada
                    de mililitro para litro. O argumento deve ser =TRUE quando
                    o usuário quiser realizar a transformação.

Details:

Caso o usuário queira realizar a transformação com o argumento L=T, a quantidade de água
deve estar obrigatoriamente em mililitro. Caso L=F, o esperado é que os valores já estejam
em litro.

Para que o produto final da função seja correto, as colunas do data.frame devem estar 
dispostas exatamente como está na explicação do argumento dados, pois há o cálculo de 
índices e indexação de colunas do data.frame.

Ao rodar a função, serão emitidas mensagens para lembrar ao usuário quais valores devem
estar em cada coluna do data.frame.

Value:

A função retorna dois gráficos.
O primeiro tem como valor nas barras a precipitação por coleta e os pontos e linhas são 
os índices de abundância calculados e plotados por coleta.
O segundo tem como valor nas barras a precipitação simulada por coleta e os pontos e linhas são
os índices de abundância simulados calculados por coleta. 

Warning:

Caso a entrada de dados não seja em formato data.frame, a função é interrompida e é gerada
uma mensagem avisando que a entrada de dados não está no formato correto.

Author(s):

Amanda Alves Camargo

amandacamargo@usp.br

See Also:

 As funções sample() e plot() podem ajudar o usuário a entender o retorno da função, principalmente
com relação ao segundo gráfico.

Examples:

##Criando objeto com o número das coletas
coletas<-rep(1:12,each=10)
##Criando objeto com a quantidade de água coletada
agua<-seq(from=100,to=350,by=50)
agua1<-rep(agua,20)
##Criando objeto com o número de indivíduos coletados
individuos<-rep(0:30,4)
##Criando objeto com os valores de precipitação
precip<-seq(from=70,to=180,by=10)
precip1<-rep(precip,10)
#Montando o data.frame com os objetos criados
dados<-data.frame(coletas,agua1,individuos,precip1)
#Rodando a função
precip.abund(dados,L=T)

##Criando vetor de números aleatórios
vetor<-c(1,3,6,8,90,4,5)
##Rodando a função
precip.abund(vetor,L=T)
#Ao rodar, o usuário receberá a mensagem de erro avisando que a entrada de dados não é um data.frame



